Release 10.1A: OpenEdge Development:
Progress Dynamics Administration

DCU XML files

The DCU is driven by the data stored in a collection of XML files. The main file is the configuration file, icfsetup.xml by default. This file is a custom version of the standard Progress Dynamics configuration file, icfconfig.xml. The DCU uses the Configuration File Manager to parse the file. The configuration file contains details of the properties required to drive the session and the managers that need to be loaded.

Because the DCU is driven by the contents of XML files, you should not need to modify the DCU procedures themselves. By modifying the XML files, you can use the DCU to deploy your application databases as well as the Progress Dynamics Repository. You can design extra pages for the DCU using the page template, and hook them into the DCU process by adding some trigger code to the pages and some XML statements to the DCU driver file.

The DCU’s standard configuration file looks like the following:

icfsetup.xml

<?xml version="1.0" encoding="UTF-8"?> <sessions>   <session SessionType="ProgressSetup">     <properties>       <ICFCM_Database>DatabaseConnectionManager</ICFCM_Database>       <physical_session_list>GUI,WBC</physical_session_list>       <session_date_format>mdy</session_date_format>       <session_year_offset>1950</session_year_offset>       <session_numeric_format>,.</session_numeric_format>       <window_title>Progress Dynamics Configuration Utility</window_title>       <valid_os_list>WIN32</valid_os_list>       <setup_type_file>db/icf/dfd/setup1000B.xml</setup_type_file>       <setup_type>ProgressSetup</setup_type>     </properties>     <managers>       <manager>         <cManagerName>ConnectionManager</cManagerName>         <cFileName>af/app/afconmgrp.p</cFileName>         <cHandleName>NON</cHandleName>       </manager>       <manager>         <cManagerName>DatabaseConnectionManager</cManagerName>         <cFileName>af/app/afdbconmgrp.p</cFileName>         <cHandleName>NON</cHandleName>       </manager>       <manager>         <cManagerName>InstallUIManager</cManagerName>         <cFileName>install/prc/inuimngrp.p</cFileName>         <cHandleName>NON</cHandleName>       </manager>       <manager>         <cManagerName>ICFDBInstallManager</cManagerName>         <cFileName>install/prc/inicfdbmngrp.p</cFileName>         <cHandleName>NON</cHandleName>       </manager>     </managers>   </session> </sessions>

For your own deployments, you can add custom managers to the list in this file. The listed managers are started by the Connection Manager at the start of the DCU session. It is recommended that you do not alter the Install UI or the ICFDB Install Managers. Instead, use them as examples for building custom managers for your application databases.